home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / disk / undel11.lha / UnDel.doc < prev    next >
Encoding:
Text File  |  1994-12-03  |  5.1 KB  |  154 lines
  1.  
  2.                           File Undeleting Utility 1.1
  3.  
  4.                  (c) 1994 Martin Mares, MJSoft System Software
  5.  
  6. ================================================================================
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    UnDel 1.1 and its documentation are Copyright (c) Martin Mares, MJSoft System
  13. Software, Prague, Czech Republic.
  14.  
  15.    This  archive  can  be  freely redistributed, as long as all of its files are
  16. included   in   their   original   form  without  any  additions,  deletions  or
  17. modifications,  and  no more than a nominal fee is charged for its distribution.
  18. All  copyright notices in the programs and accompanying documentation files must
  19. remain  on  their  places.  Also '.displayme' and other similar files may not be
  20. added.  This is generally known as FREEWARE.
  21.  
  22.    Special  permission is given to Fred Fish to distribute this program on his
  23. "Fish Disks".
  24.  
  25.    This  software  is  provided  "AS  IS"  without  warranty of any kind, either
  26. expressed  or  implied.   The author is not responsible for any damage caused by
  27. it.
  28.  
  29.  
  30. Introduction
  31. ============
  32.  
  33.    AmigaDos and its filesystem have been released some years ago. During
  34. this long period, CBM didn't release any kind of tool which would be able
  35. to check and repair disks and recover deleted files. There are many third-party
  36. utilities capable of doing such a job, but they are usually terribly slow and
  37. they don't support all standard filesystems. I have been so annoyed with this
  38. situation that I decided to try to write a good unerasing tool. UnDel is the
  39. result of this work.
  40.  
  41.    Features:
  42.  
  43.     - Supports any standard filesystem - OFS / FFS + DirCache / INTL mode
  44.  
  45.     - Very fast (only free blocks are scanned, written in assembly etc.)
  46.  
  47.     - Special option for systems with small amount of memory
  48.  
  49.     - Nice user interface in shell window  ;-)
  50.       (If some non-standard console is detected, new CON: window is opened.)
  51.  
  52.     - Recovered files are copied to another device
  53.  
  54.     - Protection bits and file note are also recovered
  55.  
  56.     - UNDEL is pure and can be made resident
  57.  
  58.  
  59. Requirements
  60. ============
  61.  
  62.    - Kickstart 2.04 or higher
  63.  
  64.    - ss.library 5.0 or higher (included in this archive)
  65.  
  66.    - 68000 or higher
  67.  
  68.  
  69. Usage
  70. =====
  71.  
  72.    UnDel must be started from the CLI.
  73.  
  74.    Syntax: UnDel <from> <to> [NOPATH] [SLOW] [NOCHECK]
  75.  
  76.    <from> - name of device or volume to recover files from. Must end with ':'.
  77.  
  78.      <to> - name of directory to copy recovered files to. Must exist.
  79.  
  80.    NOPATH - asks UnDel to ignore all paths (slight improvement of speed). All
  81.         files are shown as if they are stored in the same directory.
  82.  
  83.      SLOW - reduce memory requirements at the cost of lower speed. Use if you
  84.             have not enough memory to run UnDel in standard mode.
  85.  
  86.   NOCHECK - don't check cross-links between files. Increases speed, but the
  87.         number of cross-links is always displayed as zero.
  88.  
  89.  
  90.    After you start UnDel with appropriate options, it starts to scan the
  91. disk for deleted files (40 seconds on 120MB drive with 30MB of free space).
  92. The scanning is succeeded by checking of files, checking of data blocks (FFS
  93. disks only) and building of directory tree. At the end, file list is displayed
  94. and you are given chance to select some files to be recovered.
  95.  
  96.    Listing format:
  97.  
  98. * 23-05-93  88B     0 :tt/grep-2.0/ChangeLog
  99. |    |       |      |         |
  100. |    |         |        |          *--- file name
  101. |    |         |        *--- number of sectors cross-linked with other files
  102. |    |         *--- file size
  103. |    *--- date of last modification of the file
  104. *--- asterisk if selected, space if not
  105.  
  106.    You can use the following keys:
  107.  
  108. j,8,<up>            go up
  109. k,2,<down>            go down
  110. 9,<shift-up>            page up
  111. 3,<shift-dn>            page down
  112. 7,<shift-left>            first record
  113. 1,<shift-right>            last record
  114. s,/,+                select pattern (standard AmigaDos patterns)
  115. d,-                deselect pattern
  116. 0,<space>            toggle selection
  117. i,?,*                get info
  118. h,<help>            show help page
  119. q,<esc>,x,<ctrl-c>        quit
  120.  
  121.    Press ENTER to start undeleting. If the files are inside some directory
  122. and name of that directory is known, you are prompted whether you want to create
  123. directories for the files or to leave them all directly in the destination
  124. directory.
  125.  
  126.    If the number of cross-linked sectors is non-zero, these sectors are probably
  127. overwritten by some other data. Cross-links are detected when some sector is
  128. used by more than one deleted file and it is impossible to detect which one is
  129. the real owner of the data. This cannot appear on OFS disks, because OFS data
  130. blocks always contain which file they belong to.
  131.  
  132.  
  133. History
  134. =======
  135.  
  136. 1.0 - First publicly distributed version
  137. 1.1 - Displaying of files with corrupted date/time corrected
  138.     - Fixed bug causing UnDel to use already free memory sometimes (it might
  139.       caused a lot of Enforcer hits).
  140.     - Memory usage lowered a bit, added the Cleanup phase (it occurs between
  141.       data block checking and tree building and frees unneeded data block
  142.       records).
  143.     - Some minor code optimizations.
  144.     - If something wrong with console detected, new window is opened and used
  145.       instead of the console. You can redirect standard in/out from NIL: to
  146.       force using of this extra window.
  147.  
  148.  
  149. Notes
  150. =====
  151.  
  152.    Send comments, suggestions and bug reports to mjsoft@k332.feld.cvut.cz
  153.  
  154.